Partially addresses #230. It remains the question about the bvalue and uptake iterators: #230 (comment).

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 76.22%. Comparing base (aa0fcc8) to head (a1310e6).
⚠️ Report is 2 commits behind head on main.

@@            Coverage Diff             @@
##             main     #238      +/-   ##
==========================================
+ Coverage   76.08%   76.22%   +0.13%     
==========================================
  Files          28       28              
  Lines        1777     1779       +2     
  Branches      187      182       -5     
==========================================
+ Hits         1352     1356       +4     
+ Misses        362      361       -1     
+ Partials       63       62       -1     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

From #243 (comment)

Will add the uptake kwarg tests once PR #238 gets merged.

Done in this PR.

WDYT?

Looks OK to me. Now, the size parameter is redundant and will only have kwargs, right? e.g.

def linear_iterator(size: int | None = None, **kwargs) -> Iterator[int]:
    if size is None:
        size = _get_size_from_kwargs(kwargs)

    return (s for s in range(size))

should be

def linear_iterator(**kwargs) -> Iterator[int]:
    size = _get_size_from_kwargs(kwargs)

    return (s for s in range(size))

and so on for the rest of the iterators.

Will amend once we agree on that.

Now, the size parameter is redundant and will only have kwargs, right?

Correct, that was the thinking.